RequestList v1.0
                                Adam Dawes
                           15th September, 1995



What is RequestList?
======================

RequestList is a little utility designed to complement the Commodore
utilities, 'RequestChoice' and 'RequestFile', primarily of use in AmigaDos
shell scripts.

The programs displays a requester containing a list of text items, taken
from a file you specify when you run it. When the user selects one of the
text items by clicking on it, the line number for that entry will be
printed to stdout (so it's very convenient to redirect the output of
RequestList to an environment variable).

If the user closes the window instead of clicking on a list item, the value
'-1' is returned.



Using RequestList
=================

The parameters for RequestList are as follows:

  RequestList <title> <listfile> [pubscreen=]

         Title: The name that will be given to the window that opens
                containing the list requester. (Required)
      Listfile: The name of a file containing carriage-return seperated
                items to be included within the list.
     PubScreen: Allows you to specify a public screen for the requester to
                open upon.



Requirements
============

RequestList requires Kickstart 2 or greater.



Legal stuff
===========

RequestList is freeware. It may be distributed however and wherever you
like.

I accept no responsibility for any damage done to your system, directly or
indirectly, as a result of using RequestList. You use the program entirely
at your own risk.



History
=======

  v1.0 (39.0)

        Initial release.



Bugs
====

I've only tested this on a KS3.0 A1200. I have a suspicion that the
listview might not look right on KS2.0, please contact me if you have any
problems with it.

Also, RequestList is completely *non*-font-sensitive, and fonts with
heights other than 8 pixels will probably generate a few minor problems.
Again, if this occurs and you need it fixed, send me some email.



Contacting the author
=====================

Please do write to me if you like RequestList or if you have any problems
with it or suggestions for a new version. I can't promise to reply quickly
if you write via snail-mail, but I will always reply to email messages. I
can be contacted at:

  InterNet
     ad32@brighton.ac.uk

  FidoNet
     Adam Dawes@2:441/93.5

  SnailMail
     Adam Dawes
     47 Friar Road
     Brighton
     BN1 6NH
     England



See Also
========

I have also written another utility that complements this and the Commodore
'Request' commands. 'RequestString' is available from Aminet, and provides
a simple and easy way to prompt the user to enter some text from a script.
Amongst other things, the requester can have a default string already
entered, and may have text entered invisibly (for passwords, etc.).